<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  
  <meta http-equiv="X-UA-Compatible" content="IE=edge" >
  <title>MagicalRecord入门教程 | Grx Blog</title>
  <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1">
  <meta name="description" content="Magical Record是什么在Cocoa中存在一种技术叫Core Data，用来对数据进行持久化，类似于Java世界中的Hibernate。在新建Cocoa Application/iOS Application的向导中，有一个选项是要不要使用Core Data，当启用以后你会发现在AppDelegate.m中添加了大量与Core Data相关的代码，但是你对大部分代码不知所以然。">
<meta property="og:type" content="article">
<meta property="og:title" content="MagicalRecord入门教程">
<meta property="og:url" content="http://yoursite.com/2015/01/05/MagicalRecord入门教程/index.html">
<meta property="og:site_name" content="Grx Blog">
<meta property="og:description" content="Magical Record是什么在Cocoa中存在一种技术叫Core Data，用来对数据进行持久化，类似于Java世界中的Hibernate。在新建Cocoa Application/iOS Application的向导中，有一个选项是要不要使用Core Data，当启用以后你会发现在AppDelegate.m中添加了大量与Core Data相关的代码，但是你对大部分代码不知所以然。">
<meta property="og:updated_time" content="2016-05-12T07:05:54.000Z">
<meta name="twitter:card" content="summary">
<meta name="twitter:title" content="MagicalRecord入门教程">
<meta name="twitter:description" content="Magical Record是什么在Cocoa中存在一种技术叫Core Data，用来对数据进行持久化，类似于Java世界中的Hibernate。在新建Cocoa Application/iOS Application的向导中，有一个选项是要不要使用Core Data，当启用以后你会发现在AppDelegate.m中添加了大量与Core Data相关的代码，但是你对大部分代码不知所以然。">
  
    <link rel="alternative" href="/atom.xml" title="Grx Blog" type="application/atom+xml">
  
  
    <link rel="icon" href="/favicon.png">
  
  <link rel="stylesheet" href="/css/style.css">
</head>

<body>
  <div id="container">
    <div class="left-col">
    <div class="overlay"></div>
<div class="intrude-less">
	<header id="header" class="inner">
		<a href="/" class="profilepic">
			
			<img lazy-src="/img/rufei.jpg" class="js-avatar">
			
		</a>

		<hgroup>
		  <h1 class="header-author"><a href="/">Grx</a></h1>
		</hgroup>

		
		<p class="header-subtitle">自我管理，知识管理，时间管理，阅读，语音写作，思维导图</p>
		

		
			<div class="switch-btn">
				<div class="icon">
					<div class="icon-ctn">
						<div class="icon-wrap icon-house" data-idx="0">
							<div class="birdhouse"></div>
							<div class="birdhouse_holes"></div>
						</div>
						<div class="icon-wrap icon-ribbon hide" data-idx="1">
							<div class="ribbon"></div>
						</div>
						
						<div class="icon-wrap icon-link hide" data-idx="2">
							<div class="loopback_l"></div>
							<div class="loopback_r"></div>
						</div>
						
						
						<div class="icon-wrap icon-me hide" data-idx="3">
							<div class="user"></div>
							<div class="shoulder"></div>
						</div>
						
					</div>
					
				</div>
				<div class="tips-box hide">
					<div class="tips-arrow"></div>
					<ul class="tips-inner">
						<li>菜单</li>
						<li>标签</li>
						
						<li>友情链接</li>
						
						
						<li>关于我</li>
						
					</ul>
				</div>
			</div>
		

		<div class="switch-area">
			<div class="switch-wrap">
				<section class="switch-part switch-part1">
					<nav class="header-menu">
						<ul>
						
							<li><a href="/">主页</a></li>
				        
							<li><a href="/tags/life">随笔</a></li>
				        
							<li><a href="/archives">所有文章</a></li>
				        
						</ul>
					</nav>
					<nav class="header-nav">
						<div class="social">
							
								<a class="github" target="_blank" href="https://github.com/ruixiaoguo" title="github">github</a>
					        
								<a class="weibo" target="_blank" href="https://weibo.com/u/3984935859?refer_flag=1005055010_" title="weibo">weibo</a>
					        
								<a class="rss" target="_blank" href="#" title="rss">rss</a>
					        
								<a class="zhihu" target="_blank" href="#" title="zhihu">zhihu</a>
					        
						</div>
					</nav>
				</section>
				
				
				<section class="switch-part switch-part2">
					<div class="widget tagcloud" id="js-tagcloud">
						<a href="/tags/OC/" style="font-size: 10px;">-OC</a> <a href="/tags/Android/" style="font-size: 10px;">Android</a> <a href="/tags/Apple-Watch/" style="font-size: 10px;">Apple Watch</a> <a href="/tags/Flutter/" style="font-size: 13.33px;">Flutter</a> <a href="/tags/Life/" style="font-size: 10px;">Life</a> <a href="/tags/Lottie/" style="font-size: 10px;">Lottie</a> <a href="/tags/MMKV/" style="font-size: 10px;">MMKV</a> <a href="/tags/MonkeyKing/" style="font-size: 10px;">MonkeyKing</a> <a href="/tags/OC/" style="font-size: 20px;">OC</a> <a href="/tags/RAC/" style="font-size: 11.67px;">RAC</a> <a href="/tags/Swift/" style="font-size: 15px;">Swift</a> <a href="/tags/WKWebView/" style="font-size: 10px;">WKWebView</a> <a href="/tags/WebView/" style="font-size: 10px;">WebView</a> <a href="/tags/Xcode/" style="font-size: 18.33px;">Xcode</a> <a href="/tags/appledoc/" style="font-size: 10px;">appledoc</a> <a href="/tags/hexo/" style="font-size: 11.67px;">hexo</a> <a href="/tags/ios/" style="font-size: 10px;">ios</a> <a href="/tags/life/" style="font-size: 16.67px;">life</a> <a href="/tags/xcode/" style="font-size: 10px;">xcode</a>
					</div>
				</section>
				
				
				
				<section class="switch-part switch-part3">
					<div id="js-friends">
					
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://blog.devtang.com">唐巧的博客</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://beyondvincent.com">破船之家</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://limboy.me">无网不剩</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://msching.github.io">码农人生</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://yulingtianxia.com">玉令天下</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://blog.leichunfeng.com">雷纯锋的技术博客</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://jax.cnblogs.com">包建强</a>
			        
			          <a target="_blank" class="main-nav-link switch-friends-link" href="http://blog.cnbang.net">bang</a>
			        
			        </div>
				</section>
				

				
				
				<section class="switch-part switch-part4">
				
					<div id="js-aboutme">知识管理，时间管理，自我管理，阅读，语音写作，思维导图，Wiz，TimeMeter</div>
				</section>
				
			</div>
		</div>
	</header>				
</div>

    </div>
    <div class="mid-col">
      <nav id="mobile-nav">
  	<div class="overlay">
  		<div class="slider-trigger"></div>
  		<h1 class="header-author js-mobile-header hide">Grx</h1>
  	</div>
	<div class="intrude-less">
		<header id="header" class="inner">
			<div class="profilepic">
			
				<img lazy-src="/img/rufei.jpg" class="js-avatar">
			
			</div>
			<hgroup>
			  <h1 class="header-author">Grx</h1>
			</hgroup>
			
			<p class="header-subtitle">自我管理，知识管理，时间管理，阅读，语音写作，思维导图</p>
			
			<nav class="header-menu">
				<ul>
				
					<li><a href="/">主页</a></li>
		        
					<li><a href="/tags/life">随笔</a></li>
		        
					<li><a href="/archives">所有文章</a></li>
		        
		        <div class="clearfix"></div>
				</ul>
			</nav>
			<nav class="header-nav">
				<div class="social">
					
						<a class="github" target="_blank" href="https://github.com/ruixiaoguo" title="github">github</a>
			        
						<a class="weibo" target="_blank" href="https://weibo.com/u/3984935859?refer_flag=1005055010_" title="weibo">weibo</a>
			        
						<a class="rss" target="_blank" href="#" title="rss">rss</a>
			        
						<a class="zhihu" target="_blank" href="#" title="zhihu">zhihu</a>
			        
				</div>
			</nav>
		</header>				
	</div>
</nav>

      <div class="body-wrap"><article id="post-MagicalRecord入门教程" class="article article-type-post" itemscope itemprop="blogPost">
  
    <div class="article-meta">
      <a href="/2015/01/05/MagicalRecord入门教程/" class="article-date">
  	<time datetime="2015-01-05T08:13:45.000Z" itemprop="datePublished">2015-01-05</time>
</a>
    </div>
  
  <div class="article-inner">
    
      <input type="hidden" class="isFancy" />
    
    
      <header class="article-header">
        
  
    <h1 class="article-title" itemprop="name">
      MagicalRecord入门教程
    </h1>
  

      </header>
      
      <div class="article-info article-info-post">
        
	<div class="article-tag tagcloud">
		<ul class="article-tag-list"><li class="article-tag-list-item"><a class="article-tag-list-link" href="/tags/OC/">OC</a></li></ul>
	</div>

        

        <div class="clearfix"></div>
      </div>
      
    
    <div class="article-entry" itemprop="articleBody">
      
        <h2 id="Magical-Record是什么"><a href="#Magical-Record是什么" class="headerlink" title="Magical Record是什么"></a>Magical Record是什么</h2><p>在Cocoa中存在一种技术叫Core Data，用来对数据进行持久化，类似于Java世界中的Hibernate。在新建Cocoa Application/iOS Application的向导中，有一个选项是要不要使用Core Data，当启用以后你会发现在AppDelegate.m中添加了大量与Core Data相关的代码，但是你对大部分代码不知所以然。<br><a id="more"></a><br><br><br>Magical Record的出现在一定程度上缓解了这个问题，降低了Core Data的使用门槛。</p>
<p>Magical Record借用了Ruby on Rails中的Active Record模式，使得你可以非常容易的添加、查找、删除数据。Google了一下，没有发现中文相关教程，遂把自己的试用过程记录下来，写成此篇文章。</p>
<h2 id="安装"><a href="#安装" class="headerlink" title="安装"></a>安装</h2><ol>
<li>新建一个项目，注意在向导中不要勾选Core Data。</li>
<li>下载Magical Record，并把MagicalRecord目录拖拽到工程中，记得勾选copy items into group folder。</li>
<li>为项目添加CoreData FrameWork。(点击工程根节点，然后依次Targets &gt; Build Phases &gt; Link Binary With Libraries &gt; + &gt; CoreData.framework &gt; Add)</li>
<li><p>添加Magical Record的头文件到*-Prefix.pch：(再创建pch,添加#import <magicalrecord magicalrecord.h="">)</magicalrecord></p>
<pre><code>1.  #import &lt;MagicalRecord/MagicalRecord.h&gt;
</code></pre></li>
</ol>
<h2 id="创建模型文件"><a href="#创建模型文件" class="headerlink" title="创建模型文件"></a>创建模型文件</h2><p>下面创建一个名为Person的模型，有age、firstname、lastname三个字段</p>
<ol>
<li>创建一个名为Model的模型文件。 (File &gt; New File… &gt; Core Data &gt; Data Model)<br>点击左下角的Add Entity，更改Entity的名字为Person。</li>
<li>为Entity添加三个Attribute：age(Integer16)、firstname(string)、lastname(string)</li>
<li>点击Editor &gt; Create NSManagedObject Subclass… &gt; Create创建模型文件对应的类</li>
</ol>
<h2 id="使用Magical-Record"><a href="#使用Magical-Record" class="headerlink" title="使用Magical Record"></a>使用Magical Record</h2><h4 id="初始化Magical-Record"><a href="#初始化Magical-Record" class="headerlink" title="初始化Magical Record"></a>初始化Magical Record</h4><p>首先在AppDelegate.m中添加以下代码对Magical Record进行初始化：</p>
<pre><code> - (void)applicationDidFinishLaunching:(NSNotification *)aNotification
   {
      [MagicalRecord setupCoreDataStackWithStoreNamed:@&quot;MyDatabase.sqlite&quot;];
      // ...
      return YES;
   }
- (void)applicationWillTerminate:(NSNotification *)aNotification
   {
      [MagicalRecord cleanUp];
   }
</code></pre><p>是否比Core Data默认的初始化简洁多了呢？</p>
<h3 id="查询记录"><a href="#查询记录" class="headerlink" title="查询记录"></a>查询记录</h3><p>使用Person的MR_findAll、MR_findAllSortedBy、MR_findByAttribute等方法可以查询Person：</p>
<pre><code> //查找数据库中的所有Person。
 NSArray *persons = [Person MR_findAll];
 //查找所有的Person并按照first name排序。
 NSArray *personsSorted = [Person MR_findAllSortedBy:@&quot;firstname&quot; ascending:YES];
 //查找所有age属性为25的Person记录。
 NSArray *personsAgeEuqals25   = [Person MR_findByAttribute:@&quot;age&quot; withValue:[NSNumber numberWithInt:25]];
//查找数据库中的第一条记录
 Person *person = [Person MR_findFirst];
</code></pre><h3 id="添加记录"><a href="#添加记录" class="headerlink" title="添加记录"></a>添加记录</h3><p>使用Person的MR_createEntity方法可以方便的创建一个Person，需要使用[[NSManagedObjectContext MR_defaultContext] MR_save]来进行保存哦：</p>
<pre><code> Person *person = [Person MR_createEntity];
 person.firstname = @&quot;Frank&quot;;
 person.lastname = @&quot;Zhang&quot;;
 person.age = @26;//此处使用了LLVM的新特性，XCode 4.4可用
[[NSManagedObjectContext MR_defaultContext] MR_save];
</code></pre><h3 id="更新记录"><a href="#更新记录" class="headerlink" title="更新记录"></a>更新记录</h3><p>直接对数据库中查找到的Person进行赋值，然后使用NSManagedObjectContext保存即可更新Person：</p>
<pre><code> Person *person = ...;//此处略
 person.lastname = object;        
[[NSManagedObjectContext MR_defaultContext] MR_save];          
</code></pre><h3 id="删除记录"><a href="#删除记录" class="headerlink" title="删除记录"></a>删除记录</h3><p>使用Person的MR_deleteEntity可以方便的删除Person，模式和添加更新一致：</p>
<pre><code>Person *person = ...;//此处略
[person MR_deleteEntity];
[[NSManagedObjectContext MR_defaultContext] MR_save];
</code></pre><h3 id="小技巧"><a href="#小技巧" class="headerlink" title="小技巧"></a>小技巧</h3><h4 id="启动时MR-mergedObjectModelFromMainBundle方法报错"><a href="#启动时MR-mergedObjectModelFromMainBundle方法报错" class="headerlink" title="启动时MR_mergedObjectModelFromMainBundle方法报错"></a>启动时MR_mergedObjectModelFromMainBundle方法报错</h4><p>Core Data的模型有版本的概念，有可能在你Magical Record第一次初始化完成以后，你又更改了模型文件，导致Core Data去合并模型报错。解决办法很简单，点击菜单中的Project-&gt;Clean即可</p>
<h4 id="项目使用ARC后，编译Magical-Record不通过"><a href="#项目使用ARC后，编译Magical-Record不通过" class="headerlink" title="项目使用ARC后，编译Magical Record不通过"></a>项目使用ARC后，编译Magical Record不通过</h4><p>点击项目 -&gt; Build Phases -&gt; Compile Sources中, 双击报错的class文件, 编辑Compiler Flags加入 -fno-objc-arc</p>
<h4 id="不想使用MR-前缀"><a href="#不想使用MR-前缀" class="headerlink" title="不想使用MR_前缀"></a>不想使用MR_前缀</h4><p>只需要在*-Prefix.pch文件中添加一句#define MR_SHORTHAND即可，注意这句要在#import “CoreData+MagicalRecord.h”之前</p>
<p><br></p>
<h4 id="注：这篇文章中的MagicalRecordHelpers、MRCoreDataAction都已经不在新版本的Magical-Record中存在，都已经更改为MagicalRecord。"><a href="#注：这篇文章中的MagicalRecordHelpers、MRCoreDataAction都已经不在新版本的Magical-Record中存在，都已经更改为MagicalRecord。" class="headerlink" title="注：这篇文章中的MagicalRecordHelpers、MRCoreDataAction都已经不在新版本的Magical Record中存在，都已经更改为MagicalRecord。"></a>注：这篇文章中的MagicalRecordHelpers、MRCoreDataAction都已经不在新版本的Magical Record中存在，都已经更改为MagicalRecord。</h4>
      
    </div>
    
  </div>
  
    
<nav id="article-nav">
  
    <a href="/2015/01/18/JSON和模型之间转换iOS框架：MJExtension/" id="article-nav-newer" class="article-nav-link-wrap">
      <strong class="article-nav-caption"><</strong>
      <div class="article-nav-title">
        
          JSON和模型之间转换iOS框架：MJExtension
        
      </div>
    </a>
  
  
    <a href="/2014/11/11/在Xcode中添加多个targets进行版本控制/" id="article-nav-older" class="article-nav-link-wrap">
      <div class="article-nav-title">在Xcode中添加多个targets进行版本控制</div>
      <strong class="article-nav-caption">></strong>
    </a>
  
</nav>

  
</article>


<div class="share_jia">
	<!-- JiaThis Button BEGIN -->
	<div class="jiathis_style">
		<span class="jiathis_txt">Share to: &nbsp; </span>
		<a class="jiathis_button_facebook"></a> 
    <a class="jiathis_button_twitter"></a>
    <a class="jiathis_button_plus"></a> 
    <a class="jiathis_button_tsina"></a>
		<a class="jiathis_button_cqq"></a>
		<a class="jiathis_button_douban"></a>
		<a class="jiathis_button_weixin"></a>
		<a class="jiathis_button_tumblr"></a>
    <a href="http://www.jiathis.com/share" class="jiathis jiathis_txt jtico jtico_jiathis" target="_blank"></a>
	</div>
	<script type="text/javascript" src="http://v3.jiathis.com/code/jia.js?uid=1405949716054953" charset="utf-8"></script>
	<!-- JiaThis Button END -->
</div>






<div class="duoshuo">
	<!-- 多说评论框 start -->
	<div class="ds-thread" data-thread-key="MagicalRecord入门教程" data-title="MagicalRecord入门教程" data-url="http://yoursite.com/2015/01/05/MagicalRecord入门教程/"></div>
	<!-- 多说评论框 end -->
	<!-- 多说公共JS代码 start (一个网页只需插入一次) -->
	<script type="text/javascript">
	var duoshuoQuery = {short_name:"true"};
	(function() {
		var ds = document.createElement('script');
		ds.type = 'text/javascript';ds.async = true;
		ds.src = (document.location.protocol == 'https:' ? 'https:' : 'http:') + '//static.duoshuo.com/embed.js';
		ds.charset = 'UTF-8';
		(document.getElementsByTagName('head')[0] 
		 || document.getElementsByTagName('body')[0]).appendChild(ds);
	})();
	</script>
	<!-- 多说公共JS代码 end -->
</div>




</div>
      <footer id="footer">
  <div class="outer">
    <div id="footer-info">
    	<div class="footer-left">
    		&copy; 2019 Grx
    	</div>
      	<div class="footer-right">
      		<a href="http://hexo.io/" target="_blank">Hexo</a>  Theme <a href="https://github.com/litten/hexo-theme-yilia" target="_blank">Yilia</a> by Litten
      	</div>
    </div>
  </div>
</footer>
    </div>
    
  <link rel="stylesheet" href="/fancybox/jquery.fancybox.css">


<script>
	var yiliaConfig = {
		fancybox: true,
		mathjax: true,
		animate: true,
		isHome: false,
		isPost: true,
		isArchive: false,
		isTag: false,
		isCategory: false,
		open_in_new: false
	}
</script>
<script src="http://7.url.cn/edu/jslib/comb/require-2.1.6,jquery-1.9.1.min.js"></script>
<script src="/js/main.js"></script>






<script type="text/x-mathjax-config">
MathJax.Hub.Config({
    tex2jax: {
        inlineMath: [ ['$','$'], ["\\(","\\)"]  ],
        processEscapes: true,
        skipTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
    }
});

MathJax.Hub.Queue(function() {
    var all = MathJax.Hub.getAllJax(), i;
    for(i=0; i < all.length; i += 1) {
        all[i].SourceElement().parentNode.className += ' has-jax';                 
    }       
});
</script>

<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
</script>


  </div>
</body>
</html>